BCI NET 2

home *** CD-ROM | disk | FTP | other *** search

/ BCI NET 2 / BCI NET 2.iso / archives / telecomm / fido / filefind.lzh / FileFind / FileFind.doc < prev next >

Wrap

Text File | 1995-01-02 | 15.2 KB | 371 lines

Program: FileFind Versoin: 2.0 Date: 1-1-1995 Author: Glenn J. Schworak (503) 399-7518 (Weekends and after 5pm Pacific time) 1710 Lee St SE -*- Salem, OR 97302 BBS: Glenn's World (503) 581-6524 (FidoNet 1:3406/32) >>> You can FREQ many files from here! <<< ShareWare: $10.00 Purpose: Access messages in FidoNet type networks where file searching is preformed. Such as the echo FILEFIND on the Fido BackBone. ------------------------------------------------------------------------------ Thanks to those who have helped me test this program on various BBS systems DLG - Rick Lembree @ 1:326/209 on FidoNet Falcon - Roy Smith @ 1:375/402 on FidoNet E! - Stace Cunningham @ 1:3604/60 on FidoNet CNet - Robert Scott @ 71:1100/1 on LightNet ------------------------------------------------------------------------------ UPGRADING --------- Upgrading may require a partial or complete reconfiguration of your FileFind.cfg file. Please read these documents!!! If you are upgrading from V1.64 or lower, you MUST rebuild your config file. You can use the included sample configuration file as your guide. INSTALATION *** FOLLOW THESE INSTRUCTIONS CAREFULLY *** ----------- NOTE: The address FileFind will expect to see in the OUTBOUND directory is developed from your network address and the point address you supply! For example. If your network address is 1:3406/32.31 (line #1 in the config) and you supply the point address 9999 (line #7 above), the address that FileFind will be expecting to receive mail at will be 1:3406/32.9999 so that is the address you will export mail to and be sure to password protect the session level for that address. 1) Define a session password for the site you have defined. I will use the address 1:3406/32.9999 for example. (see note above) You wouldn't want someone getting into your system under FileFind's account. IE. SetPasswd 1:3406/32.9999 "<password>" 2) Create an account for site 1:3406/32.9999 for exporting your desired echos to. How you do this depends on what software you use. I am using XMAIL to take care of this for me so I won't give an example here. Check your manual/documentations for the program you use. Set the site name to "Amiga FileFind". (remember, the actual address depends on your config) 3) Have all mail that is sent to FileFind placed on HOLD or you will have some problems. 4) Make sure you have the packets archived with LHA in either .lha or .lzh format. This is usualy done by your mail tosser/scanner program(s). 5) Turn on the echos you want to have FileFind processing. Usualy this is the echo FILEFIND in the Fido backbone. You can also set any other echos you like. This may be other networks, or local nets only. What ever you need. Any area you turn on will be monitored by FileFind. 6) Place FileFind in any directory you like. Makes no differance. Just be sure it can be accessed when you need it. 7) Place FileFind.cfg in your S: directory. (MUST MUST MUST) Please check the sample config file for the proper syntax. The key words in the config file may be in any order, but they must all be used in order to get the proper function out of the program. Also, the lines that are blank or start with a ; may be removed to save disk space. 8) Create a banner to have added to the top of each out going message. 9) Edit S:FileFind.cfg to fit your system's needs. There are comments in the file. Just be sure that you don't have spaces in your paths or file names. The first space will mark the end of the value and start the comments. 10) If you are already registered, place FileFind.key in your S: directory. This will unlock all the power of the program. SPECIAL NOTES ------------- CNet/3 You must activate the TrimKludge key word in the config file SYSOP USAGE ----------- Have your CHRON program or aftersession script or both make a call to FileFind. Once activated, it will read the config file and take care of the rest. Simply call "FileFind". You may need to specify the path if it is not in your system's normal search path. FileFind sends text to the screen. If you want to create a log file, simply redirect the out put to your log file. IE: FileFind >>Logs:FileFind.log You may also have a seperate log file created by configuring the FileFind.cfg file. In this case, you can monitor calls to FileFind through the CLI and still get your information in the log file. When you have FileFind running automaticaly from a cron program or your aftersession program, you will most likely want to stop any output other than the log file. IE: FileFind <>NIL: PLEASE NOTE: No log file will be created unless there is at least one message addressed to one of FileFind's aliases. To take advantage of the automated update fucntion of FileFind, or even the notification and manual update function, you will need to be connected to the message echo "AMIGA_FILEFIND" through FidoNet. If this echo is not yet on BackBone in your area as of yet, you may feed this one echo from my system 1:3406/32. It should be on the BackBone quite soon. Starting with V2.0 of FileFind, there are two special entries in the config file. They are AreaKey and AreaLag. With these two key words, you can have FileFind seperate the items matched by what file area they come from. For example.... Your file list looks something like this...... Trumpet 21K 15/09/93 [01] instrument voiceto1 0K 15/09/93 [01] instrument WhipCrack 10K 15/09/93 [00] instrument wistle 94K 15/09/93 [01] instrument wistle-2 57K 15/09/93 [01] instrument ========================================================================== Total KB listed in this area : 1094 [Audio-DMCS-Music] FileName Size Date Dls Description ========================================================================== 1812ovr.LZH 69K 15/09/93 [02] 1812 overchier. Requires over 1 meg and plays for 16+ minutes Cheers.lzh 2K 15/09/93 [01] The toone from the TV show empire.lzh 201K 15/09/93 [02] A nice version of the theme to StarWars gl0001.lzh 4K 15/09/93 [01] Gordon Lightfoot toone mission.LZH 1K 15/09/93 [01] Mission Imposible MusicBox.LZH 2K 15/09/93 [01] Musicbox Dancer paperb.LZH 1K 15/09/93 [00] Paperback Writer by the Beetles stairway.LZH 29K 15/09/93 [02] Stairway to Heaven. ========================================================================== Total KB listed in this area : 309 [Audio-Effects] FileName Size Date Dls Description ========================================================================== Applause.snd 32K 04/04/94 [01] Some clapping AREYOUSU.SND 44K 04/04/94 [02] HAL questioning you... Attention.snd 8K 04/04/94 [03] Cylons from BattleStar Galactica ??? ....You would set your AreaKey and AreaLag like this.... AreaKey FileName Size Date Dls Description AreaLag 2 ....And would get a file search something like this.... toone (6) ========================================================================== >[Audio-DMCS-Music]< Cheers.lzh 2K 15/09/93 [01] The toone from the TV show gl0001.lzh 4K 15/09/93 [01] Gordon Lightfoot toone >[Audio-MOD]< mod.Ghostly 119K 03/09/93 [03] Scary sounds along with a cool toone mod.Popcorn 48K 27/08/93 [00] Very old toone mod.prelude 21K 19/05/94 [00] Quite a moving toone. Lovely and soothing. >[Pics-General]< Simpson.001 35K 22/08/93 [01] The entire zaney cartoone family! ....You see, the matches are seperated out by the file area they were found in. This could make it much easier for users to locate the right files in your replys. There is little added text since the blank lines only require one single character. And the area titles are useful and not a waste. AreaKey is the text that identifies the area title is present. This must be an exact match. Use as much text as you can to help prevent a mistake being made. If you can only identify 10 or 20 characters that are unique to the area name passing by, that may be enough. AreaLag is the number of lines to go back to get the area name. This could be 0 (zero) in some cases, but it is usualy 1 or 2 lines before the AreaKey text. In the example above, the area name was 2 lines before AreaKey text show up in the file list. (see above) USER USAGE ---------- Please read the file "Help.FileFind" and make it available to your users so they will know how to use the program properly. NOTES ----- It is assumed that you already have a program for processing file requests and creating a list of files you have available for requesting. If you do not, please get a copy before using FileFind. It is rude to say you have files to offer when you can't deliver them when they are requested. Personaly I recommend QSilver for processing the file requests that come into your system. And Mercury for creating file lists. Both of these programs are available on my system and from the author "Roger Clark" at 1:382/105 on Fido. Registration ------------ WHY? Due to the fact that so many of my programs have gone unpaid for I decided to try using a KEY file to increase the return on my efforts. This was not easy to gather the required information and write the program. WHAT DO I GAIN? In the unregistered state, FileFind will only process one key word per message. This will give you a lot of power, but many requests come through with more than one key word. When you get the KEY file you will be able to process up to 20 key words per request. This is a big help. HOW MUCH? I am asking $10.00 for the KEY file. This is not much for all the traffic that FileFind can bring to your system. The more people who see your system messages on the network, the more systems you will be called by. WHAT DO YOU NEED TO KNOW? When you decide to register, print and filling the form "FileFind.reg" and it along with your payment and I will create a KEY file for you. I will quickly send it out to you as you specify on the registration form. WHAT ABOUT UPDATES? Once you pay for one registered copy, you are entitled to unlimited upgrades and replacement key files assuming you don't abuse the right by giving your KEY to someone else or loose it over and over. (basicly, don't be a pest) WHAT ARE MY RESPONSIBILITIES? Your only responsibilities are to keep your KEY from getting onto other systems, and do report any problems you encounter back to me. Other than that the program is all yours. History ------- 1.0 FileFind comes to life! 1.1 There seems to be a conflict in the IBM world with the name RAID being used for file searching. I don't really care much about them, but to be polite I suggest not using it any more. I have set FileFind up to recognise the names ALLFIX and FILEFIND when reading through the new mail. As before, FILEFIND is to be used when you only want Amiga systems to respond to your requests. 1.2 BUG FIX - Problem with TrapToss tossing second message in a mail packet solved. Replies are now broken up into multiple packets. 1.5 DEBUG command line option removed. No longer needed. Cleaned up the look of the messages returned to the users by seperating the various file search replys by keyword. Makes it easier to read. 1.6 Added some features to make the file search more flexible and powerful and allow more file list generator programs to be used. 1.62 Added SEEN-BY: and PATH: lines to the end of each message to be more compatible with some software. 1.64 Added the ability to monitor the echos for update notices. You can have FileFind notify you and then you manualy FREQ the updates, or you can set FileFind up to automaticly FREQ the updates for you! (FidoNet only) 2.0 Cleaned up the LOG file. Some people were being confused by the REPLY TO and FROM lines. They were ment to be the message headers of the replys, but are now reversed. They are the message headers of the incoming mail. Also, no log will be created unless there is at least one message addressed to the FileFind program. (any of it's aliases) Also, LHA will no longer report an error if there is nothing to unarchive. This is now replaced with a nice little message saying NOTHING TO UNPACK. The config file has been totaly rebuilt. You can now change your ORIGIN line any time you like as long as you have a registered version of the program. Otherwise the changes you make are ignored. Reformatted the origin line to be inline with 99% of the other programs out there. Your address is the last thing on the origin line now not right after the word ORIGIN. The output in the reply messages are now exactly like they are in your banner and list files. The case of the text is no longer forced to lower. Pilicy change: Replacement key files will be given as long as there is a just cause. And the privladge is not abused. (free) Abusers must pay for new keys (if they deserve one at all) Upgrades will be given freely to all users. I will send you one at the time of your registration. After that you need to download it yourself. Or have FileFind FREQ it. You can now have FileFind skip or filter out junk text such as "No Description Available" to help prevent the wast of phone time and disk space. You can now have FileFind use your main address when replying (normal) or have it use it's own point address. Some systems didn't like mail coming from the same address as it was addressed to import on. boo hoo! You can now have FileFind seperate items by what file area they come from by using AreaLag and AreaKey in the config file. (see above for info) *** NEXT *** One system has requested an option to send replys via NETMAIL or ROUTEMAIL and not EchoMail. If other systems like this option, I will add it to the program. If no one else asks for it, I won't add it. If I do add this, it will be sysop selectable in the config file. Distribution ------------ DO NOT rename or convert this archive! Leave it as FILEFIND.LZH please. This program may be freely distributed as long as the files are not altered in any way other than the methode of archival. There must be no fees charged for this program other than the minimal copying fee normaly charged by user groups. This program may be added to any disk collections such as Fred Fish. --- NO WARRANTY EXPRESSED OR IMPLIED. USE THIS AT YOUR OWN RISK ---